home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / pcmenu.arc / PC-MENU.DOC < prev    next >
Encoding:
Text File  |  1986-02-03  |  16.1 KB  |  364 lines

  1.          ======================= P C - M E N U =======================
  2.  
  3.                     (c) Copyright 1985  by Paragon Software
  4.  
  5.                                  INTRODUCTION
  6.                                  ============
  7.  
  8.           Do you wish you could just "press a button" to start up a
  9.       program on your PC?  Do you have others use your PC who are not
  10.       familiar with DOS commands?  Do you need password protection for
  11.       your PC programs? Do you wish you could enter the time using AM
  12.       and PM instead of military time?  If you answered yes to any of
  13.       the above, then PC-MENU is for you.
  14.           You do not have to read a technical description of dynamic
  15.       batch files in order to set up PC-MENU for your use ... PC-MENUS
  16.       does all the work for you.  Just follow the steps in the next
  17.       section and PC-MENU will then be tailored for your use.  For those
  18.       who are technically minded, a technical reference section is also
  19.       provided.
  20.                               SETTING UP PC-MENU
  21.                               ==================
  22.  
  23.       Note: If you downloaded the files using the shortened file names,
  24.             you should rename them before performing the set-up steps.
  25.  
  26.                     Example -->   rename P-MENU.EXE PC-MENU.EXE
  27.                                   rename P-MENU.DOC PC-MENU.DOC
  28.                                   rename P-MNUS.EXE PC-MENUS.EXE
  29.  
  30.       1. Copy PC-MENU.EXE and PC-MENUS.EXE to your start-up diskette or
  31.          the root directory of your fixed disk.
  32.  
  33.          Fixed disk example -->   copy a:PC-MENU.EXE  c:\
  34.                                   copy a:PC-MENUS.EXE c:\
  35.  
  36.       2. Now run PC-MENUS on your start-up diskette or fixed disk.
  37.  
  38.                     Example -->   PC-MENUS
  39.  
  40.          Press a key when the copyright screen is displayed (press
  41.          the % key to change to black and white if you have trouble
  42.          reading this screen, otherwise press any other key to continue).
  43.  
  44.       3. Press the number 2 to set up your menu descriptions.  A sample
  45.          menu will be displayed the first time you do this.  From then
  46.          on, the menu you build will be displayed.  Enter the title,
  47.          menu selections, and selection prompt.  Menu selections should
  48.          begin with a number or capital letter. If you wish to change the
  49.          colors, perform selection number 3. Selection number 1 can be
  50.          used to see the effects of different colors. Normally the menu
  51.          screen will be blanked after 10 minutes of inactivity.  If you
  52.          wish to change this, perform selection number 4.
  53.  
  54.       4. If you need password protection for some menu selections,
  55.          perform selection number 5. Enter the password in the space
  56.          provided to the left of the menu selection.  Leave the password
  57.          blank if password protection is not needed.
  58.  
  59.       5. Now press selection number 6 to tell PC-MENU what you want it
  60.          to do when someone selects your menu entries.  A set of sample
  61.          DOS commands will be displayed the first time you do this.
  62.          Afterwards the commands you have entered will be displayed.
  63.  
  64.                                     --1--
  65.  
  66.  
  67.  
  68.     PC-MENU User's guide                                   Paragon Software
  69.  
  70.  
  71.       6. Press C to change the DOS commands from what is shown to what is
  72.          needed to perform the first selection.  You should enter the DOS
  73.          commands that you normally use when starting the application you
  74.          want run. Then enter MENU as the last command if you want to
  75.          return to the menu when the application finishes.  (See the
  76.          section on SAMPLE DOS COMMANDS FOR SELECTIONS). After you
  77.          complete the commands for the first menu entry, the commands for
  78.          the next menu entry are displayed and so on until all menu
  79.          entries have been set up.
  80.  
  81.       7. Selection number 7 shows the control batch file (MENU.BAT) that
  82.          is going to be set up for you to run PC-MENU. Normally you will
  83.          have no need to change this so press the enter key.  Then it
  84.          shows the control batch file (AUTOEXEC.BAT) that is
  85.          automatically run when your PC is turned on.  If you already
  86.          have an AUTOEXEC.BAT file, it will be displayed and you should
  87.          add the command MENU at the end.  If you do not have one,
  88.          PC-MENUS will have set one up for you and you need to just press
  89.          the enter key.
  90.  
  91.       8. Now press selection number 8 to save your changes and then
  92.          press 4 to save everything.
  93.  
  94.       9. Finally, perform selection number 9 to end, and PC-MENU is
  95.          ready to use.  Enter the command MENU to try it out.  If you are
  96.          satisfied with your menu, you may return to DOS and erase
  97.          PC-MENUS from your start-up diskette or your hard disk since it
  98.          was only needed to set up the menu.
  99.  
  100.           Running PC-MENU  -->   MENU
  101.           Erasing PC-MENUS -->   erase PC-MENUS.EXE
  102.  
  103.         If you need to make changes to the menu later on, simply copy
  104.       PC-MENUS back onto your disk and run it again. NOTE: IF YOU RE-
  105.       ARRANGE THE MENU SELECTIONS, THE PASSWORDS AND DOS COMMANDS MAY NO
  106.       LONGER MATCH THE SELECTIONS PROPERLY.  YOU MAY NEED TO PERFORM STEPS
  107.       4 TO 6 AGAIN AS DESCRIBED ABOVE TO MAKE CHANGES AS NECESSARY.
  108.  
  109.  
  110.                               PC-MENU  OPERATION
  111.                               ==================
  112.  
  113.           The first time PC-MENU  is run when your PC is turned on, you
  114.       will be asked for the date and time (unless you have a battery
  115.       clock on your PC).  It will display the date you entered the last
  116.       time you turned on your PC.  You only need to type in what has
  117.       changed and press enter.
  118.           Once the menu is displayed, simply press the number or letter
  119.       of the selection desired and PC-MENU  will go to work for you.  If
  120.       you press an invalid key, a help screen will be displayed. If a
  121.       selection has a password, you must enter the correct password
  122.       before the selection will be performed. Note that F1 and F2 can be
  123.       used to change the date and time. F3 will turn the time and date
  124.       display on/off (if you don't want to see the time "ticking"). Use
  125.       F4 to blank the screen.  If the screen is blanked using F4 or due
  126.       to inactivity, press any key to re-display the menu.
  127.  
  128.  
  129.                                     --2--
  130.  
  131.  
  132.  
  133.  
  134.     PC-MENU User's guide                                   Paragon Software
  135.  
  136.  
  137.                       SAMPLE DOS COMMANDS FOR SELECTIONS
  138.                       ==================================
  139.  
  140.       1. Running communications program located on same disk and directory
  141.          as PC-MENU (comments in parenthesis should not be entered):
  142.  
  143.                     BASICA PC-TALK  (Start up the program)
  144.                     MENU            (Return to the menu again)
  145.  
  146.       2. Formatting a diskette in drive b:
  147.  
  148.                     format b:     (DOS command to format a diskette)
  149.                     MENU          (Start up the menu again)
  150.  
  151.       3. Seeing what is on a diskette in drive b (the pause command is
  152.          used to give instructions and wait for a keypress):
  153.  
  154.                     pause   Insert diskette into drive b
  155.                     dir b:        (Display diskette directory)
  156.                     MENU          (Start up the menu again)
  157.  
  158.       4. Switching to basic:
  159.  
  160.                     basica        (Start up basic)
  161.                     MENU          (Start up the menu again)
  162.  
  163.       5. Returning to DOS operation (use remarks to tell how to return to
  164.          the menu):
  165.  
  166.                     rem   You are now operating under DOS.
  167.                     rem   Enter MENU to return to the main menu.
  168.  
  169.       6. Using a diskette based system with start-up diskette in drive a
  170.          and a word processor in drive b:
  171.  
  172.                     b:       (First switch to drive b)
  173.                     WP       (Start up the word processor)
  174.                     a:       (Switch back to drive a)
  175.                     MENU     (Start up the menu again)
  176.  
  177.       7. Using a fixed disk system with a spreadsheet program in a
  178.          sub-directory:
  179.  
  180.                     chdir \LOTUS     (first switch to the sub-directory)
  181.                     123              (start up the spreadsheet)
  182.                     chdir \          (return to the root directory)
  183.                     MENU             (start up the menu again)
  184.  
  185.       8. Using another copy of PC-MENU located in a sub-directory to
  186.          produce a second level menu screen:
  187.  
  188.                     chdir \MENU2    (first switch to the sub-directory)
  189.                     MENU            (start up the menu in that directory)
  190.  
  191.  
  192.  
  193.  
  194.                                     --3--
  195.  
  196.  
  197.  
  198.  
  199.  
  200.     PC-MENU User's guide                                   Paragon Software
  201.  
  202.  
  203.                               TECHNICAL REFERENCE
  204.                               ===================
  205.  
  206.           The information that PC-MENU  operates from is stored in a data
  207.       file called PC-MENU.DAT.  This file is built by PC-MENUS.EXE, but
  208.       you can edit it using an editor such as EDLIN.  The format of this
  209.       file is shown below in case you wish to modify it using an editor
  210.       instead of using PC-MENUS.EXE:
  211.  
  212.       -------Format of PC-MENU.DAT--------   -------Variables-------
  213.        A  B  C  D  "Title"                   A = Foreground Color
  214.        N  "1 - Selection Description"        B = Background Color
  215.        0  "DOS command for selection 1"      C = Border Color
  216.        0  "DOS command for selection 1"      D = Title Color
  217.        0  "MENU"                             E = Display Duration
  218.        N  "2 - Selection Description"        F = Help Color
  219.        0  "DOS command for selection 2"      G = Prompt Color
  220.        0  "MENU"
  221.        1  "PASSWD"
  222.        (and so on for each selection)        N = Screen row position
  223.       99  E  F  G  "Prompt"                      of description
  224.  
  225.           PC-MENU is run from a batch file called MENU.BAT that normally
  226.       contains the following:
  227.                                -------MENU.BAT------
  228.             first command -->  PC-MENU
  229.            second command -->  Processing your selection ...
  230.  
  231.           When you type MENU and press enter, the first command in the
  232.       above batch file starts up PC-MENU.  PC-MENU then reads PC-MENU.DAT
  233.       and displays the menu screen.  When you press a key, PC-MENU scans
  234.       for a match to the first character of a selection description.  If
  235.       it does not find a match it displays the help screen.  If a match
  236.       is found, the DOS commands associated with that selection are
  237.       written to a file called PROCESSI.BAT, and then PC-MENU stops
  238.       running.
  239.           This causes the second command in MENU.BAT to now be executed.
  240.       The word "Processing" is actually truncated by DOS to "Processi"
  241.       and thus PROCESSI.BAT begins running, which contains the DOS
  242.       commands for the selection that was chosen.  The last command for a
  243.       selection is normally MENU, which will start the process all over
  244.       again.
  245.           By placing a batch file called AUTOEXEC.BAT on your start-up
  246.       diskette or hard disk root directory, your PC will begin executing
  247.       it anytime you turn it on.  If this file contains the command MENU,
  248.       then PC-MENU will display your menu whenever your PC is turned on.
  249.       The following diagram illustrates the batch file processing:
  250.  
  251.                       +-----------------------------------------------+
  252.                       |                                               |
  253.       AUTOEXEC.BAT    V       MENU.BAT                   PROCESSI.BAT |
  254.       +----------+  +-----------------------------+  +------------------+
  255.       | MENU     |->|PC-MENU                      |->|Selection commands|
  256.       +----------+  |Processing your selection ...|  |MENU              |
  257.                     +-----------------------------+  +------------------+
  258.  
  259.  
  260.                                     --4--
  261.  
  262.  
  263.  
  264.  
  265.  
  266.     PC-MENU User's guide                                   Paragon Software
  267.  
  268.           There is one additional file read by PC-MENU called
  269.       PC-MENU.DTE.  When PC-MENU starts running, it looks to see if the
  270.       date is 01-01-1980.  If it is, it will read PC-MENU.DTE and display
  271.       it for you to enter a new date.  This new date is then written out
  272.       to PC-MENU.DTE for the next time your PC is turned on.  If the date
  273.       is not 01-01-1980, then PC-MENU skips the date and time input
  274.       processing and goes directly to waiting for a selection entry.
  275.            Below is a list of all files associated with PC-MENU. Files 4
  276.       and 5 are created by PC-MENU and files 3, 6 and 7 by PC-MENUS.
  277.  
  278.             1. PC-MENU.EXE     (the PC-MENU program)
  279.             2. PC-MENUS.EXE    (program to tailor PC-MENU to your use)
  280.             3. PC-MENU.DAT     (data file of menu information)
  281.             4. PC-MENU.DTE     (file containing previous turn-on date)
  282.             5. PROCESSI.BAT    (dynamic batch file of selection commands)
  283.             6. MENU.BAT        (batch file used to run PC-MENU)
  284.             7. AUTOEXEC.BAT    (batch file run when your PC is turned on)
  285.             8. PC-MENU.DOC     (the file containing this documentation)
  286.  
  287.  
  288.  
  289.  
  290.  
  291.                               PERMISSION TO COPY
  292.                               ==================
  293.  
  294.           You are encouraged to copy PC-MENU & PC-MENUS and pass them
  295.       on to others as long as:
  296.  
  297.        1. You do not charge anyone for the software or documentation.
  298.        2. The programs or documentation are not modified in any way.
  299.  
  300.           This method of distributing computer programs is based on three
  301.       principles:
  302.  
  303.        1. That the value and utility of software is best assessed by the
  304.           user on his/her own system.
  305.        2. That the creation of personal computer software can and should
  306.           be supported by the computing community.
  307.        3. That copying of programs should be encouraged, rather than
  308.           restricted.  The ease with which software can be distributed
  309.           outside traditional commercial channels reflects the strength,
  310.           rather than the weakness, of electronic information.
  311.  
  312.           Free distribution of software and voluntary payment for its use
  313.       eliminates advertising costs and copy protection schemes.  Users
  314.       obtain quality software at reduced cost.  They can try it out
  315.       before buying, and do so at their own pace and in the comfort of
  316.       their own home or office.  The best programs will survive, based
  317.       purely on their quality and usefulness.
  318.           If you believe in these ideals, your contribution is
  319.       solicited ($16 suggested) to help make them work. The following
  320.       invoice is provided for those of you who wish to have one for your
  321.       tax records. (Corporate Purchase agreements are available upon
  322.       request.)
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                     --5--
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                               -------------------
  335.                                     INVOICE
  336.                               -------------------
  337.  
  338.       Purchased from:                          Purchased by:
  339.  
  340.           Paragon Software                     -------------------------
  341.           P.O. Box 79069                       -------------------------
  342.           Jackson, MS  39236                   -------------------------
  343.  
  344.  
  345.       DATE:     /     /                                Invoice No. 850101
  346.       ===================================================================
  347.  
  348.       PRODUCT                         QTY          EACH            TOTAL
  349.       ------------------------------- ---          ----            -----
  350.  
  351.       PC-MENU program                  1           $16              $16
  352.  
  353.  
  354.                                   ---------------------------------------
  355.                                   PLEASE PAY THIS AMOUNT            $16
  356.       ===================================================================
  357.  
  358.       Make check payable to: Paragon Software
  359.  
  360.       Check number:
  361.                     -------------
  362.  
  363.       You may retain this invoice for your records.
  364.